home *** CD-ROM | disk | FTP | other *** search
/ APDL Best Games 3 / APDL Best Games 3.iso / _docs / thieves < prev    next >
Encoding:
Text File  |  1994-07-20  |  6.9 KB  |  160 lines

  1. Forty Thieves - A card game for one player
  2. ==========================================
  3.  
  4. RISC OS Version by Graham West
  5.  
  6. 1.0 Overview
  7. ============
  8.  
  9. Forty Thieves is a one-player card game where the objective is to obtain as
  10. high a score as possible by removing cards from seven face-up stacks of five
  11. cards. Cards can be removed if they have a value one more or one less than the
  12. current card or if they (or the current card) are a joker. If all cards are
  13. removed the pack is shuffled and redealt, but if the stock is used up the game
  14. is over. A high score table is maintained and saved to disc and the number of
  15. jokers present at the start of a game can be altered.
  16.  
  17. 2.0 The rules
  18. =============
  19.  
  20. A game of Forty Thieves is begun by shuffling a pack of 52 cards and up to
  21. five jokers together, then dealing them into seven stacks of five cards, all
  22. face-up, and piling the rest, face-down, as a stock. The top card of the stock
  23. is turned over and play can then commence.
  24.  
  25. The objective is to clear away all the cards in the seven stacks. A card may
  26. be removed from the bottom of a stack if its value is one higher or one lower
  27. than the current top card of the stock. The suits of the cards do not matter.
  28. Thus, is the current card is a three, any two or any four can be placed on top
  29. of it. If a two is placed on it the next card must be either an ace or a three
  30. and so on.
  31.  
  32. In addition, if the current card is a joker ANY card may be placed on it, and
  33. a joker may be removed from the bottom of a stack irrespective of the current
  34. card.
  35.  
  36. If no cards can be placed on the current card the next card of the stock may
  37. be turned over. If there are no more cards left in the stock the game is over.
  38.  
  39. If all seven stacks are cleared of cards one joker will be removed from the
  40. pack and the cards shuffled and dealt out again. Thus play continues, the score
  41. mounting, until the player has turned over every card in the stock and still
  42. has cards left in the stacks.
  43.  
  44. 3.0 Using the program
  45. =====================
  46.  
  47. When the !Thieves application is run it installs an icon on the right hand side
  48. of the icon bar. Clicking SELECT on this icon will cause the main game window
  49. to be displayed. Clicking MENU will display a pop-up menu which has a submenu
  50. displaying the app's information window, a quit option and an option to display
  51. the high score window.
  52.  
  53. The main game window will be set up ready to play. To move a card from a stack
  54. simply click on the stack with SELECT. If the card cannot be moved a beep will
  55. be sounded.
  56.  
  57. To turn over the next card in the stock click on the stock (or the current
  58. card) with SELECT. If there are no more cards left in the stock a beep will be
  59. sounded.
  60.  
  61. If all seven stacks are cleared the program will automatically deal out a new
  62. set of cards. If the game has ended (there are no valid moves left and cards
  63. are still present in one or more stack) the program will check if you have a
  64. high score. If so, a window will appear indicating this and prompting for your
  65. name.
  66.  
  67. Clicking MENU in the main game window displays a pop-up menu with two options.
  68. The 'New Game' option resets the score and deals out a new set of cards (use
  69. this when your game has finished or if you wish to abandon it). The 'Jokers'
  70. option leads to a submenu with a writable option. Enter the number of jokers
  71. you wish to be dealt into the pack at the start of the game (only numbers
  72. from 0 to 5 inclusive are valid) and either press the Return key or click
  73. SELECT on the option.
  74.  
  75. Clicking MENU in the high score window displays a pop-up menu allowing one of
  76. the six high score tables (a separate table is kept for each initial number of
  77. jokers; I felt this was fairer on those people who like the difficulty of only
  78. 1 joker or no jokers at all) to be displayed. Each entry features the score,
  79. the name of the person who achieved it and the date it was achieved.
  80.  
  81. The high score tables are automatically saved to disc each time it is updated. If for some reason it cannot be saved (if, for example, the file's access is
  82. set to read-only or the application was run from ArcFS) an error message will
  83. be displayed.
  84.  
  85. Similarly, if the high score tables cannot be loaded when the application is
  86. loaded a default set of tables will be created and an error message displayed.
  87.  
  88. 4.0 Scoring
  89. ===========
  90.  
  91. Points are scored for:
  92.   Removing a card from a stack
  93.   Clearing all seven stacks
  94.  
  95. Individual cards score based on their face value and are valued as follows:
  96.   Ace           8 points
  97.   2             6 points
  98.   3             6 points
  99.   4             4 points
  100.   5             4 points
  101.   6             2 points
  102.   7             2 points
  103.   8             2 points
  104.   9             4 points
  105.   10            4 points
  106.   Jack          6 points
  107.   Queen         6 points
  108.   King          8 points
  109.   Joker         Nothing
  110.  
  111. If you manage to clear all seven stacks a fifteen point bonus will be given.
  112.  
  113. 5.0 Customisation, programming info and credits
  114. ===============================================
  115.  
  116. The application is shipped with 3D templates (the author firmly believes that
  117. everybody should have RISC OS 3.1 by now) but recognises that not everyone will
  118. be able to (or want to) use them. Therefore, inside the application directory
  119. are two template files, named 'Templ_3D' and 'Templ_2D'. Simply copy the
  120. appropriate file into the same directory, naming it 'Templates'. This will
  121. overwrite the existing template files with the desired version.
  122.  
  123. This application was written in ANSI C, compiled with Acorn DDE C v4.0 and
  124. used the excellent DeskLib 2.0 to take the hassle out of the interface. The
  125. author recommends this invaluable programming library to any serious desktop
  126. programmer.
  127.  
  128. There are no high-res sprites for either the application icon or the playing
  129. cards and I apologise for this but as I have only a standard fixed-sync Acorn
  130. monitor I have no way of satisfactorily viewing the sprites or testing the
  131. code with them. Donations of multi-sync monitors will be gratefully received :)
  132.  
  133. The author was inspired to write this application after playing 'Thieves and
  134. Kings' under MS Windows 3.1, which was written by Paul DeWolfe (Thieves and
  135. Kings, that is, not Windows; wouldn't that be an insult?!)
  136.  
  137. Thanks to Paul Walker (and his housemates and friends) for acting as general
  138. play testers and boosting my ego.
  139.  
  140. Thanks also to Jason Martin for pointing out that I had spelled 'Forty' wrong
  141. initially. It's one of those words I always have trouble with...
  142.  
  143. 6.0 About the author
  144. ====================
  145.  
  146. Graham West is a Computer Science student at Bradford University. He likes to
  147. read, listen to music (most things from Slayer & Anthrax to Gerry Rafferty &
  148. The Spin Doctors), roadie and monitor engineer for bands (strictly on an
  149. amateur basis, although he has worked for the Jim Rose Circus Sideshow, the Milltown Brothers and Consolidated among others) and he is a keen grower of
  150. giant tomatoes. Well, we think he may have lied about the tomatoes but the rest
  151. is definitely true.
  152.  
  153. Should you wish to contact him, write to:
  154.         Graham West
  155.         58 Clearmount Road
  156.         Rodwell
  157.         Weymouth
  158.         Dorset
  159.         DT4 9LE
  160.